home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 002 / docfile.arc / PLAY.DOC < prev    next >
Encoding:
Text File  |  1987-07-30  |  4.3 KB  |  91 lines
  1.           PLAY                                Michael J. Mefford
  2.           Command                                     1987/No. 8
  3.  
  4.           ______________________________________________________
  5.  
  6.           Purpose:  Provides many of the music-producing
  7.                     functions of the BASIC PLAY statement without
  8.                     the need to work in BASIC.
  9.  
  10.           Format:   [d:][path]PLAY[/K]   (Option I)
  11.                     [d:][path]PLAY string[/K]  (Option II)
  12.                     [d:][path]PLAY filespec/F[/K]  (Option III)
  13.  
  14.           Remarks:  Entered at the DOS prompt with no arguments
  15.                     on the command line (Option I), PLAY looks in
  16.                     the current directory for a file named
  17.                     PLAY.DAT and executes the commands in that
  18.                     file.  The PLAY.DAT file included on this
  19.                     disk is "Greensleeves."  The file can be
  20.                     examined, and similar files created, with a
  21.                     regular ASCII word processor.
  22.  
  23.                     Alternatively, PLAY can use either a command-
  24.                     line string (Option II) or any legal DOS
  25.                     filename (Option III) to supply the music
  26.                     command arguments.  Filenames may include a
  27.                     path designation, but must include the /F
  28.                     terminator.  A sample file "score," STING.DAT
  29.                     is contained on this disk.
  30.  
  31.                     Pressing any key while PLAY is executing will
  32.                     terminate operation unless the /K switch has
  33.                     been added.
  34.  
  35.                     The command set used with PLAY is shown on
  36.                     the following page and is exemplified in the
  37.                     PLAY.DAT and STING.DAT files.
  38.                                The PLAY Command Set
  39.  
  40.                     K    Keyboard.  K will cause PLAY not to poll
  41.                          the keyboard during play.  If K is not
  42.                          found, any keystroke will exit.
  43.  
  44.                     On   Octave.  n is a decimal number between 0
  45.                          and 6.  Middle C starts 03. The default
  46.                          is 04.
  47.  
  48.                     Ln   Length of time the notes will be played
  49.                          until the next L command is encountered.
  50.                          n is a decimal number between 1 and 64.
  51.                          For example, L4 = quarter-note and L8 =
  52.                          eighth note.
  53.  
  54.                     Tn   Tempo is the pace at which the music is
  55.                          played.  n is a decimal number between
  56.                          32 and 255.  The larger the number, the
  57.                          faster the pace.  The default is T120.
  58.  
  59.                     A-G  Letter names corresponding to the notes
  60.                          of the scale.  The letter name may be
  61.                          followed by either a # or + for a sharp,
  62.                          or a - for a flat.  O3C = middle C.
  63.  
  64.                     Nn   Note to be played.  n is a decimal
  65.                          number between 1 and 84.  Each increment
  66.                          is 1/12 of an octave.  N can be used as
  67.                          an alternative to defining a note by a
  68.                          letter and an octave.  For example, N37
  69.                          = middle C.
  70.  
  71.                     Pn   Pause, or rest, for a length defined by
  72.                          n.  P works in the same way as the L
  73.                          command above.  For example, P2 = a half
  74.                          rest.
  75.  
  76.                     MN   Music Normal.  The note is played 7/8 of
  77.                          its specified time, and 1/8 is a rest
  78.                          between notes.  This is the default.
  79.  
  80.                     ML   Music Legato.  The note is played the
  81.                          full length of time specified.
  82.  
  83.                     MS   Music Staccato.  The note is played 3/4
  84.                          of the time specified, and 1/4 is a rest
  85.                          between notes.
  86.  
  87.                     .    Dot.  A dot can follow a letter note or
  88.                          a pause.  A dotted note increases play
  89.                          time by half the duration of the note or
  90.                          pause.  More than one dot may be used.
  91.